<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <title>Per-user alias address</title>
        <link rel="stylesheet" type="text/css" href="./css/markdown.css" />
    </head>
    <body>

    <div id="navigation">
    <a href="https://www.iredmail.org" target="_blank">
        <img alt="iRedMail web site"
             src="./images/logo-iredmail.png"
             style="vertical-align: middle; height: 30px;"
             />&nbsp;
        <span>iRedMail</span>
    </a>
    &nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="per-user-alias-address">Per-user alias address</h1>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<p>Check out the lightweight on-premises email archiving software developed by iRedMail team: <a href="https://spiderd.io/">Spider Email Archiver</a>.</p>
</div>
<div class="toc">
<ul>
<li><a href="#per-user-alias-address">Per-user alias address</a><ul>
<li><a href="#manage-per-user-alias-addresses-with-iredadmin-pro">Manage per-user alias addresses with iRedAdmin-Pro</a></li>
<li><a href="#sql-backend-manage-per-user-alias-addresses-with-sql-command-line">SQL backend: Manage per-user alias addresses with SQL command line</a></li>
<li><a href="#ldap-backend-manage-per-user-alias-addresses">LDAP backend: Manage per-user alias addresses</a></li>
</ul>
</li>
</ul>
</div>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<ul>
<li>This document is applicable to iRedMail-0.9.7 and later releases.</li>
<li>Here's <a href="./user.alias.address-20170701.html">doc for iRedMail-0.9.6 and earlier releases</a>.</li>
</ul>
</div>
<p>Since iRedMail-0.9.3, we have per-user alias address support, that means mail
user <code>john.smith@domain.com</code> can have additional email addresses like
<code>john@domain.com</code>, <code>js@domain.com</code> and more, all emails sent to these addresses
will be delivered to same mailbox (<code>john.smith@domain.com</code>). With per-user
alias address support, you don't need to create separated mail alias accounts
anymore.</p>
<h2 id="manage-per-user-alias-addresses-with-iredadmin-pro">Manage per-user alias addresses with iRedAdmin-Pro</h2>
<p>You can manage per-user alias addresses with iRedAdmin-Pro in user profile
page, under tab "Aliases".</p>
<p><img alt="" src="./images/iredadmin/user_profile_aliases.png" width="1024px" /></p>
<h2 id="sql-backend-manage-per-user-alias-addresses-with-sql-command-line">SQL backend: Manage per-user alias addresses with SQL command line</h2>
<p>Add additional email addresses <code>sales@domain.com</code>, <code>bill@domain.com</code> for
<strong>existing</strong> user <code>john@domain.com</code>:</p>
<pre><code>sql&gt; USE vmail;

sql&gt; INSERT INTO forwardings (address, forwarding,
                              domain, dest_domain,
                              is_alias, active)
                      VALUES ('sales@domain.com', 'john@domain.com',
                              'domain.com', 'domain.com',
                              1, 1);

sql&gt; INSERT INTO forwardings (address, forwarding,
                              domain, dest_domain,
                              is_alias, active)
                      VALUES ('bill@domain.com', 'john@domain.com',
                              'domain.com', 'domain.com',
                              1, 1);
</code></pre>
<ul>
<li>Account <code>sales@domain.com</code> and <code>bill@domain.com</code> are NOT existing mail user
  accounts.</li>
<li>In above sample, <code>bill@domain.com</code> could be an email address which belongs
  to your alias domain.</li>
<li>You can add as many additional email addresses as you want.</li>
</ul>
<h2 id="ldap-backend-manage-per-user-alias-addresses">LDAP backend: Manage per-user alias addresses</h2>
<p>For LDAP backend, per-user alias addresses are stored in LDAP attribute
<code>shadowAddress</code> of user object, and attribute/value pair
<code>enabledService=shadowaddress</code> is required. For example:</p>
<pre><code>dn: mail=john@domain.com,ou=Users,domainName=domain.com,o=domains,dc=xxx,dc=xxx
enabledService: shadowaddress
shadowAddress: sales@domain.com
shadowAddress: bill@domain.com
...
</code></pre><div class="footer">
    <p style="text-align: center; color: grey;">All documents are available in <a href="https://github.com/iredmail/docs/">GitHub repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://github.com/iredmail/docs/archive/master.zip">download the latest version</a> for offline reading. If you found something wrong, please do <a href="https://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
</div></body></html>